home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / Util / Commodities / CatchDisk1_20.lha / CatchDisk / italiano / documentazione / CatchDisk.doc next >
Text File  |  1994-05-12  |  19KB  |  499 lines
  1.  
  2.  
  3.  
  4. -------------------------------------------------------------------------------
  5.                             CatchDisk: Guida utente                            
  6. -------------------------------------------------------------------------------
  7.  
  8.  ------------------------------------------------------------------------------
  9.                       CatchDisk versione 1.20 26-Apr-1993
  10.                       Copyright © 1994 By Alessandro Sala
  11.                              dedicato a Cristina
  12.  
  13.  
  14.              Richiede AmigaOS v2.04 ( Kickstart v37 ) o successivo
  15.              e WBStart-Handler v1.4 o successivo (by Stefan Becker)
  16.  ------------------------------------------------------------------------------
  17.  
  18.  
  19.                                    Contenuti
  20.  
  21.  
  22.                        - Informazioni legali        
  23.                        - L'archivio di distribuzione
  24.                        - Introduzione
  25.                            Cos'è CatchDisk ?        
  26.                            Installazione            
  27.                        - Configurazione e utilizzo  
  28.                        - Terminare CatchDisk        
  29.                        - Indirizzi per contatti     
  30.                        - Storia delle revisioni     
  31.  
  32.  
  33.  
  34.  
  35.       ******************************************************************
  36.  
  37.  
  38.         NOTA: Il mio indirizzo E-Mail è cambiato. Il nuovo indirizzo è:
  39.  
  40.  
  41.       +----------------------------------------------------------------+
  42.       |                                                                |
  43.       |                         Alessandro Sala                        |
  44.       |                                                                |
  45.       |                   tser1500@cdc8g5.cdc.polimi.it                |
  46.       |                                                                |
  47.       +----------------------------------------------------------------+
  48.  
  49.  
  50.  
  51. -------------------
  52. Informazioni legali
  53. -------------------
  54.  
  55.                              ----------------
  56.                               Responsabilità
  57.                              ----------------
  58.  
  59.  
  60.    Questo programma è fornito SENZA alcuna garanzia, né esplicita né implicita,
  61. di adeguatezza ad un particolare utilizzo. Sebbene sia stata posta la massima
  62. cura nel rendere questo programma 'system-friendly' e privo di bug, l' intero
  63. rischio per quello che riguarda i risultati, l' affidabilità e le prestazioni
  64. di questo programma è assunto dall' utente: NESSUNA responsabilità potrà essere
  65. imputata all' Autore per qualsivoglia danno prodotto dal programma stesso.
  66.  
  67.  
  68.                             -------------------
  69.                              Nota di Copyright
  70.                             -------------------
  71.  
  72.  
  73.    Questo programma è 'FreeWare': può essere liberamente copiato e distribuito
  74. per fini non commerciali e comunque non di lucro, purché non venga aggiunto né
  75. eliminato alcun file dall' archivio di distribuzione, e non venga richiesto
  76. alcun pagamento, a parte un eventuale contributo ai costi di copia.
  77.  
  78.  
  79.   Fred Fish è, naturalmente, esplicitamente autorizzato a distribuire questo
  80. programma mediante la sua 'disk library' e/o i suoi CD-ROM.
  81.  
  82.  
  83.    Tuttavia il programma rimane Copyright dell' Autore: sono vietate operazioni
  84. di 'reverse engineering', adattamenti e qualunque altra modifica al programma,
  85. alla documentazione e ad ogni altro file presente nell' archivio, tranne dove
  86. ciò sia esplicitamente premesso.
  87.    E' permesso comprimere il programma in una forma eseguibile per uso
  88. personale, non per la distribuzione. Le uniche due forme permesse di distribu-
  89. zione sono l'archivio lha originale o una sua forma decompressa.
  90.    Inoltre è vietato incorporare il programma in un altro software senza il
  91. permesso scritto dell' Autore.
  92.  
  93.  
  94.  
  95. ---------------------------
  96. L'archivio di distribuzione
  97. ---------------------------
  98.  
  99.  
  100.                    -----------------------------------------
  101.                    Contenuto dell' archivio di distribuzione
  102.                    -----------------------------------------
  103.  
  104.  
  105.     CatchDisk           : Il programma principale
  106.     CatchDisk.info      : Relativo file '.info' con tooltypes predefiniti
  107.  
  108.  
  109.     Italiano
  110.       Leggimi           : Informazioni generali in lingua italiana
  111.       Documentazione
  112.         CatchDisk.doc   : Documentazione italiana in formato ASCII
  113.         CatchDisk.guide : Documentazione italiana in formato AmigaGuide
  114.       Installa          : Programma di installazione in italiano (vedi Leggimi)
  115.  
  116.     English
  117.       Readme            : Informazioni generali in lingua inglese
  118.       Documentation
  119.         CatchDisk.doc   : Documentazione inglese in formato ASCII
  120.         CatchDisk.guide : Documentazione inglese in formato AmigaGuide
  121.       Install           : Programma di installazione in inglese (vedi Readme)
  122.  
  123.     Deutsch        ( traduzioni di Jan-Claas Dirks )
  124.       Liesmich          : Informazioni generali in lingua tedesca
  125.       Dokumentation
  126.         CatchDisk.dok   : Documentazione tedesca in formato ASCII
  127.         CatchDisk.guide : Documentazione tedesca in formato AmigaGuide
  128.       Install           : Programma di installazione in tedesco (vedi Liesmich)
  129.  
  130.  
  131.     Catalogs
  132.       CatchDisk.ct        : File di traduzione vuoto
  133.       italiano
  134.         CatchDisk.catalog : File di supporto per la lingua italiana
  135.       deutsch
  136.         CatchDisk.catalog : File di supporto per la lingua tedesca
  137.                                         (traduzione di Jan-Claas Dirks)
  138.  
  139.  
  140.     Vari file '.info'
  141.  
  142.  
  143.  
  144. ------------
  145. Introduzione
  146. ------------
  147.  
  148.  
  149.  
  150.                                Cos'è CatchDisk ?
  151.                                ----------------
  152.  
  153.  
  154.    CatchDisk è una semplice commodity, la cui principale funzione consiste nel
  155. rilevare l' inserimento di nuovi dischi nei drives e verificare se sono già
  156. correttamente formattati: se non lo sono viene lanciato il programma Format
  157. con il drive già selezionato. All' utente non resta che scegliere le opzioni
  158. e attivare la formattazione o annullare l' operazione. A partire dalla versione
  159. 1.20, CatchDisk può riconoscere vari dischi in formato non-DOS e ignorarli o
  160. eseguire un programma a scelta dell'utente, quando vengono inseriti.
  161. Per ulteriori informazioni e altre caratteristiche di CatchDisk, continuate
  162. a leggere.
  163.  
  164.  
  165.                                   IMPORTANTE
  166.                                   ----------
  167. Per potere utilizzare CatchDisk è necessario installare nella vostra directory
  168. L: il programma WBStart-Handler VERSIONE 1.4 O SUCCESSIVA. WBStart-Handler è
  169. prodotto da Stefan Becker ed è liberamente distribuibile: l' archivio di
  170. distribuzione è 'WBStart1_4.lha'. Assicuratevi che la versione sia almeno la
  171. 1.4, perché con versioni precedenti, a causa di un problema nella gestione dei
  172. lock nulli nell' handler, CatchDisk non funzionerebbe correttamente.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                  Installazione
  179.                                  -------------
  180.  
  181.  
  182.    Per installare CatchDisk, se avete l'utility 'Installer' della Commodore
  183. (vedi 'Leggimi'), potete semplicemente eseguire l'icona 'Installa' che trovate
  184. nel cassetto 'Italiano'.
  185.    Altrimenti è sufficente copiare CatchDisk in un cassetto, tipicamente
  186. SYS:WBStartup. Se avete OS 2.1 o successivo e volete sfruttare la
  187. localizzazione, dovete anche copiare il cassetto 'catalogs', che si trova
  188. nell'archivio di distribuzione, nello stesso cassetto di CatchDisk, oppure potete
  189. copiare il file 'CatchDisk.catalog' (si trova in 'catalogs/<lingua>/') in
  190. 'LOCALE:catalogs/<lingua>/', dove <lingua> è quella desiderata.
  191.    Se la vostra lingua non è ancora supportata, potete completare il file di
  192. traduzione che trovate nel cassetto 'catalogs' ( catalogs/CatchDisk.ct ) e
  193. inviarmelo via E-Mail (vedi la sezione Indirizzi per contatti ). Io creerò
  194. un nuovo file '<vostra-lingua>/CatchDisk.catalog' e ve lo invierò via E-Mail il
  195. più presto possibile, e la prossima versione di CatchDisk supporterà una nuova
  196. lingua. Potete anche tradurre i file di documentazione ed inviarmeli perché
  197. siano inclusi nella distribuzione di CatchDisk.
  198.    Assicuratevi inoltre di avere installato nella vostra directory L: il
  199. WBStart-Handler versione 1.4 o successiva (vedi 'Cos'è CatchDisk')
  200.  
  201.  
  202.  
  203. -------------------------
  204. Configurazione e utilizzo
  205. -------------------------
  206.  
  207.  
  208.   Per lanciare CatchDisk è sufficente 'bi-cliccare' la sua icona o dare il
  209. comando 'run CatchDisk' da una CLI. Per averlo attivo ad ogni boot, mettetelo
  210. nel cassetto SYS:WBStartup con il tooltype 'DONOTWAIT', oppure inserite il
  211. comando 'run CatchDisk' nel file S:user-startup.
  212.   CatchDisk riconosce i seguenti tooltype o argomenti da CLI:
  213.  
  214.  
  215.         CX_PRIORITY=<pri>     : La priorità di CatchDisk nella rete delle
  216.                                   commodity.
  217.                                   Default = 0. Intervallo = da -128 a 127
  218.  
  219.  
  220.         DEVICE<n>=<drive>...  : Descrive un gruppo di drives alternativi per
  221.                                   un singolo drive fisico.
  222.                                   Il numero <n> identifica un gruppo di drives
  223.                                   alternativi, e può assumere valori da 0 a 9.
  224.                                   Il parametro <drive> è un nome di drive
  225.                                   seguito da ':' ed è possibile elencare un
  226.                                   numero qualsiasi di drives, senza spazi
  227.                                   interposti.
  228.  
  229.  
  230.                                 Esempio:
  231.  
  232.  
  233.                                      'DEVICE0=DF0:PC0:'
  234.  
  235.  
  236.                                   indica che perché un disco sia considerato
  237.                                   correttamente formattato deve essere leggibile
  238.                                   accedendo al drive come DF0: oppure come PC0:
  239.                                   Se in nessuno dei due casi il disco risulta
  240.                                   leggibile, CatchDisk tenterà di identificarlo
  241.                                   leggendo i primi 4 bytes della traccia 0 (che
  242.                                   sono i 4 caratteri che potete vedere come
  243.                                   nome dell'icona del disco sul Workbench, dopo
  244.                                   DFx:). Se il disco viene riconosciuto, viene
  245.                                   intrapresa un'azione in base ai tooltypes
  246.                                   REQUESTER e ID<x>, altrimenti ,in base al
  247.                                   tooltype REQUESTER, verrà eseguito il
  248.                                   programma di formattazione sul primo drive
  249.                                   della lista (nel nostro esempio sarà DF0:).
  250.  
  251.  
  252.                                 Se si fosse invece indicato:
  253.  
  254.  
  255.                                       'DEVICE0=PC0:DF0:'
  256.  
  257.  
  258.                                   in caso di disco non formattato o non rico-
  259.                                   nosciuto sarebbe stato formattato come 'PC0:'.
  260.  
  261.  
  262.                                 Se uno o più dei drives elencati non sono
  263.                                   montati, vengono semplicemente ignorati.
  264.  
  265.  
  266.  
  267.         BREAK_WARN            : Quando CatchDisk termina a causa di un segnale
  268.                                   ^C, esso visualizza un requester che vi
  269.                                   informa dell'evento solo se BREAK_WARN
  270.                                   è definito.
  271.  
  272.  
  273.  
  274.         RESCAN=<sec>          : Forza CatchDisk ad effettuare una nuova scansione
  275.                                   dei vari devices ogni <sec> secondi. Questo
  276.                                   permette a CatchDisk di accorgersi quando
  277.                                   viene montato un device che non invia il
  278.                                   messaggio 'diskinserted' (es. dischi simulati
  279.                                   montati mediante FMS).
  280.                                   Default = 0 (niente rescan).
  281.  
  282.  
  283.  
  284.         FORMATTER=            : Permette di specificare un programma di formatta-
  285.                                 zione diverso da 'SYS:System/Format', che è il
  286.                                 default. Dovete specificare il percorso completo
  287.                                 del programma da eseguire.
  288.  
  289.  
  290.         ID<x>=<id>[,<nome>[,<path&file>]] :
  291.                               Descrive un formato disco non-DOS.
  292.                               La cifra <x> può variare tra 0 e 9: i numeri
  293.                                 più bassi vengono controllati prima.
  294.  
  295.  
  296.                               <id> è un identificatore di quattro caratteri
  297.                                 che deve coincidere con i primi 4 bytes della
  298.                                 traccia 0 del disco, per identificarlo.
  299.                                 Ci sono due caratteri speciali:
  300.  
  301.  
  302.                                     $ : Corrisponde solo ad una cifra (0-9)
  303.                                         o ad un '$'.
  304.  
  305.  
  306.                                     ? : Corrisponde a qualsiasi carattere.
  307.  
  308.  
  309.                                 Così, per esempio, Qb$$ identifica tutti i
  310.                                 dischi di Quarterback (Qb01, QB02 ecc.).
  311.  
  312.  
  313.                               <nome> è un testo che viene utilizzato per
  314.                                 comunicare all'utente che tipo di disco 
  315.                                 CatchDisk ha identificato. Viene anche usato
  316.                                 come etichetta per il gadget del requester
  317.                                 (vedi sotto). Se non è fornito il disco
  318.                                 verrà sempre ignorato, indipendentemente
  319.                                 dal tooltype REQUESTER.
  320.  
  321.  
  322.                               <file&path> è il path e il nome del programma
  323.                                 che viene eseguito quando CatchDisk identifica
  324.                                 questo formato. L'esecuzione di questo programma
  325.                                 è l'azione di default che viene intrapresa
  326.                                 da CatchDisk se il tooltype REQUESTER vale NOID
  327.                                 o NEVER. Se <file&path> non è fornito, viene
  328.                                 utilizzato il programma di formattazione.
  329.  
  330.  
  331.                               Potete trovare alcuni esempi nell'icona di
  332.                                 CatchDisk.
  333.  
  334.  
  335.         REQUESTER=<quando>      : Dove <quando> vale NEVER, ID, NOID o ALWAYS.
  336.                                   Quando CatchDisk rileva un disco non-DOS,
  337.                                     può eseguire un'azione di default oppure
  338.                                     può aprire un requester per chiedere
  339.                                     all'utente cosa fare.
  340.  
  341.  
  342.                                   Per i dischi illeggibili/non riconosciuti
  343.                                     le azioni possibili sono 'Formatta' o
  344.                                     'Ignora'. Il default e 'Formatta'.
  345.  
  346.  
  347.                                   Per i dischi riconosciuti, le azioni sono
  348.                                     'Ignora', 'Formatta', o 'esegui il
  349.                                     programma' indicato nel relativo tooltype
  350.                                     ID<x>. Il default consiste nell'esecuzione
  351.                                     del programma indicato. 
  352.  
  353.  
  354.                                   Se <quando>=NEVER, CatchDisk procede sempre
  355.                                     con l'azione di default (vedi sopra), senza
  356.                                     chiedere all'utente.
  357.  
  358.  
  359.                                   Se <quando>=ID, CatchDisk apre il requester
  360.                                     solo per i dischi identificati, altrimenti
  361.                                     esegue l'azione di default.
  362.  
  363.  
  364.                                   Se <quando>=NOID, CatchDisk apre il requester
  365.                                     solo per i dischi illeggibili o non
  366.                                     riconosciuti, altrimenti esegue l'azione
  367.                                     di default.
  368.  
  369.  
  370.                                   Se <quando>=ALWAYS, CatchDisk apre sempre il
  371.                                     requester. 
  372.  
  373.  
  374.    Quando CatchDisk è attivo, potete usare il programma Commodities Exchange per
  375. controllarne l' attività.
  376.  
  377.  
  378.  
  379. --------------------
  380. Terminare CatchDisk 
  381. --------------------
  382.  
  383.  
  384. Essendo una commodity, CatchDisk può essere terminato in tre modi:
  385.  
  386.  
  387.   a) Eseguite CatchDisk una seconda volta.
  388.  
  389.  
  390.   b) Usate il programma Commodities Exchange.
  391.  
  392.  
  393.   c) Inviate a CatchDisk un segnale 'control-C' (vedi anche BREAK_WARN):
  394.  
  395.  
  396.     c.1) Se avete lanciato CatchDisk da workbench (o dal cassetto WBStartup)
  397.          usate una utility di controllo dei task come TaskX di Steve Tibbet.
  398.  
  399.  
  400.     c.2) Se avete lanciato CatchDisk da una CLI (o da user-startup) fate così:
  401.  
  402.  
  403.           1) Aprite una CLI
  404.           2) Date il comando 'STATUS' e notate il numero di processo di CatchDisk
  405.           3) Date 'BREAK <n> C' dove <n> è il numero di processo visto sopra
  406.  
  407.  
  408.  
  409. ----------------------
  410. Indirizzi per contatti
  411. ----------------------
  412.  
  413.  
  414.                             Critiche e suggerimenti
  415.                             -----------------------
  416.  
  417.  
  418.    Spero che troviate CatchDisk utile, e se avete delle critiche, dei
  419. suggerimenti, segnalazioni di bug, idee per miglioramenti in eventuali nuove
  420. versioni, oppure se avete problemi con CatchDisk e avete bisogno di aiuto,
  421. potete scrivermi ( in Italiano o in Inglese ) al seguente indirizzo:
  422.  
  423.  
  424.         Alessandro Sala
  425.         Via A. Grandi, 16
  426.         20014 Nerviano (MI)
  427.         Italy
  428.  
  429.  
  430.    Se potete usare la posta elettronica (E-Mail), potete anche contattarmi al
  431. seguente (nuovo) indirizzo Internet (almeno fino alla fine di Luglio 1994):
  432.  
  433.  
  434.         tser1500@cdc8g5.cdc.polimi.it
  435.  
  436.  
  437.  
  438. ----------------------
  439. Storia delle revisioni
  440. ----------------------
  441.  
  442.  
  443. **********************************************************************************
  444.                                    Revisioni
  445. **********************************************************************************
  446.  
  447.  
  448. -------------
  449. Versione 1.20
  450. -------------
  451.  
  452.  
  453.     - Eliminati vari bug che si presentavano in presenza di più di un device
  454.     PCx: (doppie richieste di formattazione, richieste di formattazione
  455.     all'estrazione di un disco ecc.). Risolti i problemi nel riconoscimento di 
  456.     dischi NDOS in presenza di un device PCx:.
  457.  
  458.  
  459.     - Aggiunta la capacità di identificare dischi non-DOS (suggerito anche
  460.     da Jan-Claas Dirks) e intraprendere delle azioni definite dall'utente.
  461.  
  462.  
  463.     - Aggiunti requester opzionali prima di eseguire qualsiasi azione.
  464.  
  465.  
  466.     - Aggiunta la possibilità di utilizzare un programma di formattazione
  467.     scelto dall'utente.
  468.  
  469.  
  470.     - Aggiunto il supporto per la lingua Tedesca (grazie a Jan-Claas Dirks).
  471.  
  472.  
  473.  
  474. -------------
  475. Versione 1.10
  476. -------------
  477.  
  478.  
  479.     - Quando CatchDisk viene riattivato, dopo essere stato disattivato tramite
  480.     'Exchange', effettua una nuova scansione dello stato dei vari devices per
  481.     verificare se vi sono nuovi dischi da formattare.
  482.  
  483.  
  484.     - Aggiunto il tooltype 'RESCAN=<sec>' che forza CatchDisk ad effettuare
  485.     una nuova scansione dello stato dei vari devices ogni <sec> secondi, così
  486.     da rilevare anche quelli che non inviano i messaggi 'diskinserted' e
  487.     'diskremoved', per es. dischi simulati montati mediante FMS (segnalato da
  488.     Frank Schliefer)
  489.  
  490.  
  491.  
  492.  
  493. -------------
  494. Versione 1.00
  495. -------------
  496.  
  497.  
  498.      Prima release.
  499.